home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / Communication / Archie / README
Text File  |  1993-06-27  |  6KB  |  120 lines
  1. Archie - A NeXT specific Archie client
  2.  
  3. Archie 2.09a is a 3.0 NeXTSTEP analog of George Ferguson's
  4. Xwindow based archie client.  It provides all of its functionality with
  5. the niceties of the NeXTSTEP interface, as well as documents and
  6. interactive ftp sessions.  The program is based on the query.[ch],
  7. ftplib.[ch], and Prospero library subset provided with George's 2.0
  8. beta version of Xarchie.
  9.  
  10. I am now using RTF source for most of the new classes in the
  11. Archie application. The use of RTF in the class implementation files
  12. allows for nicely formatted and very readable code. The class
  13. header files are still plain text since InterfaceBuilder does not yet
  14. parse RTF headers. Compiling the RTF code is accomplished with
  15. Rtf_Compiler utilities written by Charles Lloyd. The Rtf_Compiler
  16. should be available in the pub/next/submission directory of
  17. sonata.cc.purdue.edu.
  18.  
  19. This version is markedly improved over the previous versions, 1.37
  20. and below.  If you have NeXTSTEP version 3.0, I highly
  21. recommend obtaining the new version.  This preliminary release is
  22. being made to allow for input on additional features or changes to
  23. the current features.  A description of the current features follows.
  24.  
  25. Archie Documents
  26.     Archie now makes use of documents called  ArchieSessions.
  27. An ArchieSession is simply a collection of queries accessible from
  28. a single document using a browser interface similar to previous
  29. versions of Archie. Any new query initiated from the interface is
  30. added to the ArchieSession document. The documents can be
  31. saved for later access.  Any expansion of directories in the initial
  32. archie server response are saved in the document.
  33. Any number of ArchieSession documents can be open.  Double
  34. clicking on an Archie doc opens it in Archie as you would expect.
  35.  
  36. Automatic Expansion of Directories
  37.     Previous versions of Archie would allow one to obtain a listing
  38. of directories returned by the archie server by initiating an FTP
  39. session with the host on which the directory resided.  This version
  40. does "automatic" expansion of directories by sending another
  41. request to the archie server who provided the info on the directory.
  42. This is generally much faster and cleaner.
  43.  
  44. File Transfers Use Remote FTPD Directly
  45.     I no longer fork a child process which in turns uses the ftp
  46. program to retrieve files. I have created a category called
  47. Object(FTPDaemon) which provides the methods necessary to
  48. interact directly with a remote ftpd server.  The category is based on
  49. the ftplib.[ch] files provided with George's Xarchie.
  50.  
  51. Interactive FTP Sessions
  52.     Once you have received a query result from the archie server,
  53. you can initiate an interactive FTP session by selecting a hostname
  54. in column 0 and choosing "Connect..." from the FTP menu.  This
  55. causes a browser containing the top level files of the host's
  56. anonymous ftp directory to be displayed.  At this point you are
  57. speaking directly with the remote ftpd.  You can traverse the remote
  58. file system much as you can in the Workspace browser.  Selected
  59. directories or files can be retrieved using the "Retrieve..." command
  60. from the FTP menu.  Any number of FTP sessions can be active.
  61. You can also initiate an interactive FTP session to an arbritrary host
  62. at any time via the "General FTP..." item under the FTP menu.  The
  63. general FTP session does not have to be to an anonymous host.
  64.  
  65. Support for Opening Files in the Workspace
  66.     One can open files from both the ArchieSession and interactive
  67. FTP file browsers by double clicking on a file. Most any type of file
  68. that could be opened in the Workspace can be opened from the
  69. browsers. A current limitation is that only regular files can be
  70. opened. This means that, for example, a remote .rtfd package
  71. cannot be opened with Edit.
  72.  
  73. Current Limitations & Problems
  74.     Not extensively tested - I have gotten all of the features I
  75. wanted (with the exception of multiple active queries) incorporated,
  76. and my day to day usage is no longer flushing out problems.
  77. However, I have not tried to break program.
  78.     One active archie query - Although I have written the
  79. NeXTSTEP portion of the program with support for multiple active
  80. archie server queries, I have not yet made the archie / Prospero
  81. code from the Xarchie program thread safe.
  82.     Help not complete - There actually is a good deal of help
  83. information. The parts not complete include help clicking on
  84. interface objects, cross-referencing of the help topics, and setting
  85. up the index.
  86.     Sketchy display of links with FTP sessions - Links are
  87. displayed in the FTP session browser simply as "link_name ->
  88. link_target".  Although links are actually resolved, I just have not
  89. tested the display mechanism.
  90.     Drag & drop transfers - I have implemented a file well type of 
  91. class which allows one to drag a selection from the ArchieSession
  92. interface to an application which implements the NXDestination
  93. protocol for file names.  Although it does work, it does not work very
  94. well.  The problem is that if you drag a file from the Archie interface
  95. to a folder in the Workspace, the Workspace asks for the file name
  96. prior to getting the file icon actually over the folder. It most likely
  97. does this to verify that the file exists.  Since the file does not exist on
  98. the local host, I have to initiate an FTP session to obtain a local
  99. copy.  The name of the local copy is then placed on the Pasteboard
  100. for the Workspace.  During the transfer, the file icon cannot be
  101. moved and if you let go without having gotten the icon over the
  102. intended folder, the copy operation fails.
  103.     Directories and file packages can not be opened in Workspace
  104. - I have not yet added the ability to open directories or file packages
  105. (e.g., .rtfd files) in the Workspace.
  106.  
  107. Send in your comments
  108.     This initial release is to get a number of people using the
  109. program so that any remaining errors and problems can be flushed
  110. out.  I appreciate the input you have provided for previous versions,
  111. and I encourage all to continue to send me suggestions, bugs, no
  112. matter how small.
  113.  
  114. And finally, obtaining Archie
  115.     The binary may now be obtained via anonymous ftp from cs.orst.edu.
  116.  
  117.  
  118. Scott Stark        Sat Jun 26 08:15:19 CDT 1993
  119. stark@superc.che.udel.edu    (NeXT mail accepted)
  120.